.TH lha_consistency_checker 1 "18 April 2012" "TrueCL Commands"

.SH NAME
lha_consistency_checker \- Check Consistency of Configuration Data

.SH SYNOPSES
.TS
l l.
clreq	[\fB--no\fP|\fB--yes\fP] [\fB-timeout\fP \fIN\fP] [\fB--lwidth\fP \fIN\fP]
	[\fB--debug\fP|\fB--verbose\fP|\fB--quiet\fP|\fB--silent\fP]
.TE

.SH DESCRIPTION
The \fIlha_consistency_checker(1)\fP utility is used to check that all information
contained in the configuration database used for the cluster is consistent 
across all nodes (where relevant).

This utility is most useful after making significant number of changes to the
cluster configuration to ensure all such changes have been replicated correctly.

By default any possible problems/fixes will cause a prompt to appear to give the
opportunity of a fix if one is deemed sensible. This action can be changed via the 
\fB--no\fP or \fB--yes\fP arguments.

.SH ARGUMENTS
.TP 8
--no
Indicates that any differences found should simply be reported - no actual
changes should take place. It is often sensible to run the utility in this 
mode to report possible changes and give no chance of actually makig them. 
.TP
--yes
Automatically make any changes across the cluster configurations. Use with
care!
.TP
--timeout
The amount of time to wait for a node to respond to a request to
indicate whether it is alive or not. Defaults to 10 seconds if not
specified.
.TP
--debug
Generate debug levels of output.
.TP
--verbose
Verbose mode generates a sensible amount of output to standard output to 
show the progress of running the utility.
.TP
--quiet
This will only produce errors and warnings on the standard output device.
.TP
--silent
Only produce output if fatal errors occurs during cluster formation.

.SH OUTPUT
If any changes are found these are always shown on the output
no matter what the output flags are.

.SH EXIT CODES
If no changes are necessary or all attempted changes are successful then
the return code will be '0', A non-zero return code indicates a failure - 
messages indicating the reason for failure will be shown on the
standard error device.

.SH FILES
The utility uses standard error and output for all messages depending on
the configured logging level. 

The configuration database on each node - $TRUECL_CFG/config.db - is read
separately on each node to determine the consistency of the information
contained.

.SH NOTES
Running this command on a regular, automated basis with the \fB--no\fP setting
is considered good practise.

.SH AUTHOR
The TrueCL software was written by Simon Edwards, (C) 2006-2012, working
for Advantsys Computer Services Ltd - www.advantsys.co.uk.

.SH SEE ALSO
.BR lha_build(1),
.BR lha_bulldapp(1).

.SH AVAILABILITY
This utility was specifically written under the GNU GPL license and as required
by such software comes with \fIno warranty or guarantee of any kind\fP. For
more information, please see the following page: truecl.advantsys.co.uk.

